🧧 红包核销系统使用说明

普通红包 & 共享红包完整核销指南

📋 核销流程概述

红包核销是指用户领取红包后，在合作店铺消费时使用红包抵扣金额的过程。

1

用户领取红包

通过分享链接或扫码领取红包，系统自动生成8位验证码

2

获取验证码

用户在"我的红包"页面查看验证码

3

到店核销

店员输入验证码进行核销

4

系统验证

验证有效性、权限、状态

5

核销完成

更新状态，记录消费信息

🔑 验证码系统

🎫

验证码格式

8位大写字母+数字组合
例如：A1B2C3D4

⏰

有效期

与红包有效期一致
过期自动失效

🔒

安全性

一次性使用
核销后立即失效

⚖️ 核销权限对比

店铺角色 普通红包 共享红包 说明
创建店铺 ✅ 可以核销 ✅ 可以核销 红包的创建者
合作店铺 ❌ 不能核销 ✅ 可以核销 已建立共享关系的店铺
其他店铺 ❌ 不能核销 ❌ 不能核销 未建立共享关系

💻 技术实现

核心核销函数

// 红包核销核心逻辑
@transaction.atomic
def verify_red_packet(code, store, verified_by):
  // 1. 验证码基础验证
  verification_code = VerificationCode.objects.get(
    code=code.upper(),
    is_used=False
  )
  
  // 2. 过期检查
  if receiver.is_expired:
    return False, "验证码已过期"
  
  // 3. 权限验证（核心差异）
  if store == source_store:
    // 普通红包：创建店铺核销
  elif hasattr(red_packet, 'sharing_config'):
    // 共享红包：合作店铺核销
  
  // 4. 佣金处理（共享红包特有）
  if 跨店消费:
    记录佣金分配

💰 佣金分配机制（共享红包）

🏪

创建店铺收益

获得佣金收入
客户资源共享

🛍️

核销店铺收益

获得客户消费
提升店铺流量

🤝

合作共赢

打破信息孤岛
建立商业生态

佣金计算公式： 佣金金额 = 红包金额 × 佣金比例

📱 操作指南

店员核销操作

  1. 登录店铺管理后台
  2. 进入"红包核销"页面
  3. 输入用户提供的8位验证码
  4. 点击"核销"按钮
  5. 查看核销结果

用户查看验证码

  1. 登录用户端APP/小程序
  2. 进入"我的红包"页面
  3. 找到要使用的红包
  4. 查看8位验证码
  5. 向店员出示验证码

⚠️ 注意事项

重要提醒：
  • 验证码区分大小写，请使用大写字母
  • 每个验证码只能使用一次，核销后立即失效
  • 请确认店铺有权限核销该类型红包
  • 共享红包需提前建立共享关系才能核销
  • 过期红包无法核销，请及时使用
温馨提示：
  • 核销过程全程自动化，无需人工审核
  • 系统自动记录所有核销记录，便于对账
  • 共享红包的佣金自动结算，无需手动操作
  • 遇到问题可联系技术支持

🎯 总结

红包核销系统提供了统一、安全、高效的核销解决方案：

统一流程

普通红包和共享红包使用相同的核销界面和流程

智能权限

系统自动识别红包类型并验证核销权限

自动结算

共享红包佣金自动计算和分配